home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Games Machine 80
/
XENIATGM80.iso
/
Shareware
/
Dragon Unpacker 4.00 Final
/
readme.txt
< prev
next >
Wrap
Text File
|
2000-01-28
|
28KB
|
683 lines
Dragon UnPACKer v4.00 Freeware
(c)Copyright 1999-2000 Alex Devilliers / Dragon Software 28-01-2000
===============================================================================
** English Readme (voir lisezmoi.txt pour la version franτaise)
(mire Leeme.txt para el espa±ol)
** For information about what's new in this version see the whatsnew.txt file
Index:
1. Legal Stuff & Distribution Information
2. Program Description
3. Installation
4. Needed to work
5. How-to use this program
6. HyperRipper
7. Options
8. Supported Formats
9. Contact me
10. Special Thanks
===============================================================================
1. LEGAL STUFF & DISTRIBUTION INFORMATION
-------------------------------------------------------------------------------
First of all, this program is freeware, that means you should not have paid to
use it, nor for download it except cost of normal comms.
Any public version (beta, release candidate or final) can be placed on any
media for distribution (ex: CD-Rom, FTP, HTTP, etc..). But all text files must
stay intact, and no files can be added to the zip file.
File should be named Dup4?????.zip (where ????? is the version number and the
distribution type, ex: Dup400.zip for the version 4.00 Final).
You can also name it Dragon UnPACKer v4.??.?? ????.zip.
===============================================================================
2. PROGRAM DESCRIPTION
-------------------------------------------------------------------------------
This program allow you to see into the big files in games like Quake 2 (go
look in the baseq2 sub directory, see the big pak0.pak file, that's one) and
extract files to anywhere you want easily. It can also convert some weird
formats to common formats (like .ART Duke Nukem 3D files to Windows BitMaP .BMP
files).
And from version 4 Dragon UnPACKer have a Windows Explorer like user
interface, it is now multi-lingual (select at startup) and is slightly faster
than version 2 and 3.
See the SUPPORTED FORMATS chapter to known which files are readable.
===============================================================================
3. INSTALLATION
-------------------------------------------------------------------------------
Keep Sub-directories when unZIPping the Dragon UnPACKer archive.
Dragon UnPACKer is a Visual Basic 6 program, that means if you cannot run the
program file (.exe) then you must download the big setupvb6.zip file (2 Mb)
from where you found Dragon UnPACKer or from the Internet homepage of Dragon
UnPACKer (see end of file).
You should first of all install SETUPVB6.ZIP by uncompressing zip file to a
temporary folder. Then right-click on the .INF file and select INSTALL.
Then you should copy all .DLL files found in the Dragon UnPACKer folder
(CMDLGFR.DLL, MSCMCFR.DLL and VB6FR.DLL) to your Windows SYSTEM directory
(should be c:\windows\system\).
WARNING: You MUST keep the UNZIP32.DLL file in the Data sub-directory of
Dragon UnPACKer.
That's all. You should be able to run Dragon UnPACKer from now on and any
other Visual Basic 6 program without downloading again those big DLLs...
Here is a list of files you must find in the Dragon UnPACKer distribution:
(if not go to homepage and download it from there)
*CMDLGFR.DLL 32 Kb
*DRGUNPACK4.EXE 488 Kb (Packed using UPX v0.94)
HISTORIQUE.TXT 42 Kb
LEEME.TXT 14 Kb
LISEZMOI.TXT 32 Kb
*MSCMCFR.DLL 138 Kb
README.TXT 27 Kb
*VB6FR.DLL 117 Kb
WHATSNEW.TXT 29 Kb
DATA\CESTINA.LNG 16 Kb
*DATA\COMMON.GDP 4 Kb
+DATA\COMMON.LKB 3 Kb (Needed for multi-lingual support)
+DATA\ENGLISH.LNG 16 Kb
DATA\ESPANOL.LNG 17 Kb
DATA\ITALIANO.LNG 16 Kb
*DATA\UNZIP32.DLL 140 Kb
UTILS\DLNGC.EXE 42 Kb (Packed using UPX v0.84)
UTILS\DLNGC.TXT 3 Kb
UTILS\ENGLISH.LS 22 Kb
UTILS\ESPANOL.LS 16 Kb
UTILS\HRF_SPECS.TXT 7 Ko
UTILS\ITALIANO.LS 16 Kb
UTILS\TRANSLATE.TXT 2 Kb
UTILS\UNINSTALL.EXE 10 Kb (Packed using UPX v0.94)
* Needed files for DRGUNPACK4.EXE to work.
+ Needed files for english translation of DRGUNPACK4.EXE.
===============================================================================
4. NEEDED TO WORK
-------------------------------------------------------------------------------
You will need:
* Windows 95/98/NT
Was tested under Windows 98, Windows 98 SE and Windows 2000.
BEWARE: The UNINSTALL.EXE program does nothing under Windows 2000.
(The registry keys are not removed).
Author's computer:
* Windows 98 SE or Windows 2000
* Celeron 450/100
* 128 Mb of SDRam
* IBM 14Gb 7200rpm HD
(when i say something is fast you should test it before by yourself!! :) )
Some tips:
* If you can set the Temporary directory to a RAM Disk (at least 8 Mb) it
will be much faster.. :)
* Temporary directory MUST exist and must be WRITE-CAPABLE, if not Dragon
UnPACKer will pop-up many errors.
===============================================================================
5. HOW TO USE THIS PROGRAM
-------------------------------------------------------------------------------
Introduction:
-------------
Just run DRGUNPACK4.EXE.
If it is the first time you run it, you will have to select your language.
Default language is French. But English is also available.
--> If you want to make a translation to your language go to UTILS sub-dir and
read the TRANSLATE.TXT file.
That is the only thing you should configure in order to use this program.
There is more options, but if you are not an expert user you should not be
changing them (Dragon UnPACKer could stop working).
Interface:
----------
There is a Menu, a Tool Bar, 2 Explorer Lists and a Status Bar.
Here is a list of all menus:
Menu Description
File > Open Allow to open a file which format is
supported (see Supported Formats chapter)
File > Close Allow to close an opened file.
This action is automatic when you do
File > Open.
File > HyperRipper Allow to open a file which format is unknown
(see the HyperRipper chapter).
Search Only displayed when a file is opened and
searching is supported.
Allow you to display all files which name
include the string you typed.
Options > Basic Open the configuration panel of Dragon
UnPACKer on Basic options tab.
Options > Advanced Open the configuration panel of Dragon
UnPACKer on Advanced options tab.
Options > File Association Open the configuration panel of Dragon
UnPACKer on File Association tab.
? > About... Display information about the Dragon UnPACKer
The Tool Bar have the following buttons (in order of appearence):
Open Close | Options | See Edit Extract Convert | Stop
Left-Side Explorer:
-------------------
It displays the tree of directories in the file you opened, beginning by the
filename itself, then directories. Example:
--- Exemple.PAK
|--- Sound
|--- Maps
|--- Textures
By clicking on the filename or on a directory the program will display in the
Right-Side Explorer all files found in that directory.
By right-clicking you get a Pop-Up menu.
If you click on the filename, you will get 2 options:
+ Extract all...
Allow to extract all files from the opened file to a directory.
This option is not always available.
Directories tree is keeped.
+ Informations
Open a little information window about the opened file and about the driver
used to open this file format.
If you click on a directory, you will have 1 option:
+ Extract sub-directories...
Allow to extract all files in this directory and all sub-directories.
This option is not always available.
Directories tree is keeped.
Right-Side Explorer:
--------------------
It displays the list of files in the opened file, a directory in this file or
the result of the search. Example:
File Size Offset Description
Exemple1.WAV 36201 12 Sound (RIFF/WAVE)
Exemple2.WAV 97321 36213 Sound (RIFF/WAVE)
Here is an explanation for each column:
+ File
The filename
+ Size
The size in bytes of the file
+ Offset
The offset of the file (starting at offset #0) in the opened file.
This information is only useful for expert users.
+ Description
Give the file type (Sound, Picture, etc..) and if possible his format
(RIFF/WAVE, MPEG, etc..).
By default this explorer list have a picture in wallpaper, you can disable it
in the Basic Options (this will speed-up display).
You can also put your wallpaper picture, by putting the BACK.JPG file in the
Data sub-directory of Dragon UnPACKer.
By double-clicking on a filename you will launch the default option, it can
be Extract file, or Open file by external utility. This depends of your options
it is by default Extract file.
By right-clicking on the filename you will have 4 options:
+ Convert file...
This option is only available if the selected file is convertable.
It will open the convert window that allow you to convert weird formats to
common files (ex: Half Life .WAD textures to Windows BitMap .BMP files).
+ Edit file
Open the file with an external program (using the Windows Registry under
the sub-key: Shell/Edit/Command).
+ Extract file
This will open a dialog box allowing you to select destination directory &
filename, for extraction.
+ Open file
Open the file with an external program (using the Windows Registry).
Example: .TXT files are opened by Notepad :o).
You can select many files at once, then if you right-click you will have 2
options:
+ Convert files...
This option is only available if ALL selected files have same format and
a convertable format.
It is the same option as for single file but for many files at once.
+ Extract files...
Allow you to extract all selected files to a directory.
This program also allow extraction by Drag & Drop.
Just Drag a file from the List to the Desktop or Windows Explorer for example
and Drop it there. The program will extract it to this directory.
Command line:
-------------
You can run Dragon UnPACKer with following options:
DrgUnPack4.exe /lng
Displays the language selection box on start-up.
DrgUnPack4.exe <file.ext>
Open the file.ext file.
===============================================================================
6. HYPER RIPPER
-------------------------------------------------------------------------------
!!! Expert users only !!!
Introduction:
-------------
This method for opening files allow you to scan it for embedded file formats:
AVI - Audio-Video Interleace
BMP - Windows BitMap pictures
EMF - Windows Enhanced MetaFile
FLIC - Autodesk Animator FLIC files
GIF - Graphics Interchange Format pictures
IFF - Interchange File Format pictures
JPEG - JPEG Interchange File Format (JFIF) pictures
MIDI - Music files
MOV - QuickTime Movie
MPEG Audio - MPEG Layer III (also known as MP3)
PNG - Portable Network Graphics pictures
VOC - Sounds (Creative VOice)
WAV - Sounds (RIFF/WAVE)
WMF - Windows MetaFile (Aldus Placeable format)
How to use it:
--------------
Using the HyperRipper is pretty easy, but the results can seem quite bizare.
For example the HyperRipper will find files thinking there are of the searched
format, but that's not sure at 100%.
First of all select the file you wish to scan (Source file).
Select formats you wish to search for. You should select only files that may
appear in the scanned file. For example if you scan SNDFILE.DAT, you should
search only for Sound formats, and remove Picture formats (PNG, IFF/LBM, BMP).
The HyperRipper will be faster when only 1 format is selected.
MPEG Audio search is VERY SLOW. Only check this format when really needed.
When finished selecting the formats to search for, click on the Search! button
you will then have to wait some time (can be very long for Big files of 200Mb).
If you can put the file to scan on a RAM Disk, then DO IT!!!
'Create HyperRipper File' option:
---------------------------------
If you check this option, the HyperRipper will create a companion file of the
source file with the .HRF extension (you can change this filename as you like)
that will store all results from the HyperRipper. That will allow you to open
the .HRF file later with Dragon UnPACKer and have the list of found files
without having to redo the search in the HyperRipper.
The HRF format have an option (in the 'Options' tab). You have the choice
between 2 versions of the file:
+ Version 0 is the default, this file type will always be the smaller, but
had no options (ex: Rename found files).
+ Version 1 is the extended format, it stores the filename, so it is bigger
(25% bigger than same file in version 0) but allow you to rename found
files (from now it is impossible by using Dragon UnPACKer, but very easy by
using an Hexadecimal editor).
'MPEG Audio' options:
---------------------
This option tab allow you to restrict the search for MPEG Audio.
First of all there is a table with 3 lines and 3 columns.
First column is for MPEG 1 format.
Second column is for MPEG 2.0 format.
Third column is for MPEG 2.5 format.
First line is for Layer I.
Second line is for Layer II.
Third line is for Layer III.
Each format have its own sub-formats (sample rate, bit rate) but you should
know that MPEG 2.5 is an unofficial format created to support low Bit Rates and
sample rates (ex: 8Khz at 8 KBps). You should also know that the most used
format is the Layer III (named MP3 or MPEG3), it is also the only format that
could be tested with the HyperRipper.
To select a format in order to search it in the HyperRipper only check the
option. To the right there is 3 buttons (1, 2 and 3) allowing you to select
only the Layer to search (ex: Layer I, Layer II or Layer III).
Limits:
By puting limits on the search you will lower the possibility of having false
MPEG Audio detected in files by limiting the number frames (a MPEG Audio file
is built up using a large amount of frames, the frame contents is the music)
and/or the size.
I think a lower limit of 5 frames should be the minimum to use (an MPEG3 file
for example have 40 frames per second), by default is set to 20 (0.5 seconds).
The lower size limit should also be set to at least 2048 bytes.
Maximum size limit should only be used to cut the MPEG Audio in many parts
instead of having an HUGE signle MPEG Audio file.
Beware, setting the Maximum limit lower than the Minimum limit will not work..
Special:
There is sometimes special things in MPEG Audio files (mainly MPEG3).
That's why there is 2 options:
+ Search Xing VBR Header:
Xing Tech. added a small header to their VBR (Variable Bit Rate) MPEG Audio
files. When present and this option used this will speed-up the HyperRipper.
Recommended.
+ Search ID3Tag v1.0/v1.1:
ID3Tag are informations about the song, Title, Author, etc..
This is found at the end of the file. If this option is not checked the
program will ignore any ID3Tag and will not add them to the file.
ID3Tag v2.0 (found in the start of files) are not supported, and will not
be supported.
===============================================================================
7. OPTIONS
-------------------------------------------------------------------------------
Basic Options:
--------------
+ Do not display Splash screen
This will remove the introduction box (Dragon UnPACKer) displayed for 1 sec
on start-up. Recommended for a faster startup.
+ Do not play sound when search is finished.
Will not play any sound when search is finished.
+ Do not use background picture
Remove the background picture from the right-side explorer.
Recommended for a smoother scrolling.
+ Save size and position of windows
This will allow you to retrive the Dragon UnPACKer windows in the same state
as when you close it.
This option also store the width of the Columns from the right-side
explorer list.
+ Full Row Selection
The selection on the right-side list will be on the full row and not only
on the filename.
+ Use Smart Format Detection when opening files
By default the program will check the file format by looking at his
extension but sometimes this is impossible, so by checking this option the
program will read the file header to check for the file format. Recommended.
+ Always use last used directory
This allow you to always have the last used directory as default directory
when opening/extracting/etc...
+ Use HyperRipper when opening unknown file format
If the opened file have an unknown format the program will run the
HyperRipper to scan the file for embedded files.
Recommended for expert users.
+ Language
Allow you to select the language used for Dragon UnPACKer.
Language change is made on-the-fly (no restart needed).
The homepage URL displayed is the Language file author one.
(See Utils\Translate.Txt)
Advanced Options:
-----------------
+ Buffer memory
This is the amount of memory buffer to use in order to extract files and to
search in files by using the HyperRipper (limited to 32Kb for the
HyperRipper).
Value by default: 4096 Bytes (4K)
+ Color Palettes (for convertion)/Open the palette manager
Open the Palette manager window.
Only for expert users. You should not be using this option.
+ Temporary Directory
Allow you to set up the teporary directory to use when opening/edit a file,
for the HyperRipper, etc...
The DIRECTORY MUST EXIST if not you will get many errors.
- By default: Fix the temporary directory to the Windows temporary
directory (API GetTempPath). RECOMMANDED.
- If not you can select a directory by clicking on the [+] button.
If you can select a temporary directory that is on a RAM Disk (at least
8 MB).
Extraction from ZIP files is done to this Temporary directory (and moved to
the destination directory).
+ Options for 'Open file'
- Make 'Open file' the default option (else it will be 'Extract file')
Explicit.
- Default program to use:
This is the program that will open the file if no program is associated
in the Windows registry or is the association is bad.
File association:
-----------------
This section allow to associate files to Dragon UnPACKer to be able to open
those file in the windows explorer (for example) with Dragon UnPACKer.
If an extension is checked it is associated with Dragon UnPACKer.
+ Verify associations at start-up:
The program will check associations at start-up and will fix them if bad.
+ Use external icon:
If you think the Dragon UnPACKer icon is ugly, use your own.
+ Change the association text:
Allow to change the text in the description of the file format.
===============================================================================
8. SUPPORTED FORMATS
-------------------------------------------------------------------------------
If there is a file format you want to be supported by Dragon UnPACKer, contact
the author (see the Contact Me chapter).
Game Extension Tested on
Age of Empires 2 .DRS Age of Empires 2 v1.00 Final
Alien vs Predator .FFL Alien vs Predator v0.98
#Breakneck (N.I.C.E.2) .SYN Breakneck/NICE2
Blood .ART Blood v1.00
Dark Force .GOB Dark Force v1.02
DarkStone .MTF DarkStone v1.00 US & DarkStone v1.03 FR
*Delta Force 1 .PFF Delta Force 1 (Fr)
*Delta Force 2 .PFF Delta Force 2 (v1.00.11)
Descent 1 .HOG Descent 1 v1.0 & v1.4
Descent 2 .HOG --UNTESTED--
Descent 3 .HOG Descent 3 v1.0
#Doom 1 .WAD Doom 1 v1.9
#Doom 2 .WAD Doom 2 v1.666
Duke Nukem 3D .ART Duke Nukem 3D v1.3D & 1.4
Duke Nukem 3D .GRP Duke Nukem 3D v1.3D & 1.4
Dune 2 .PAK Dune 2 (Original European Version)
Dungeon Keeper 2 .SDT Dungeon Keeper 2 v1.0 (VF)
Dungeon Keeper 2 .WAD Dungeon Keeper 2 v1.0 (VF)
Excessive Speed .SYN Excessive Speed
Freespace .VP Conflict Freespace v1.02 Fr
Freespace 2 .VP Freespace 2 v1.00
Half Life .PAK Half Life v1.0.1.5
Half Life .WAD Half Life v1.0.1.5
#Heretic .WAD --UNTESTED--
Heretic 2 .PAK Heretic 2 v1.0
Heroes of Might & Magic 3 .SND Heroes of Might & Magic 3 (Fr)
#Hexen .WAD --UNTESTED--
Hexen 2 .PAK Hexen 2 v1.11 (Fr)
Hidden & Dangerous .DTA Hidden & Dangerous v1.1
(HyperRipper) .HRF Dragon UnPACKer v4.00
Indiana Jones 3D .GOB Indiana Jones 3D v1.2 (US)
MDK .SNI MDK: Mission Laguna Beach
Mortyr .HAL Mortyr v1.00
Quake .PAK Quake v1.08
Quake .WAD Quake v1.08
Quake 2 .PAK Quake 2 v3.20
Quake 3 Arena .PK3 Quake 3 Arena Test v1.05 to v1.08
Revenant .RVI Revenant v1.00 US
Revenant .RVM Revenant v1.00 US
Revenant .RVR Revenant v1.00 US
Shadow Warrior .ART Shadow Warrior
Shadow Warrior .GRP Shadow Warrior
System Shock 2 .CRF System Shock 2 v1.0 (US)
Terminal Velocity .POD Terminal Velocity v1.2
Thief .CRF Thief - The Dark Project
Tribes .VOL Tribes
Trickstyle .PAK Trickstyle
* = Some files don't work properly.
# = Experimental Driver (Incomplet and/or untested).
Total: Supported Games = 40
Supported Formats = 27
If you find other games that work with current drivers please contact Alex
Devilliers with the game name and version.
If any driver fail to work with a game that should be working, also contact
Alex Devilliers. (see end of file)
Formats to be supported (IN PROJECT)
------------------------------------
Game Extension Informations
Blizzard Games .MPQ Don't expect much..
If you really need use MPQView.
Descent 1 .PIG DDN Specification is bad. So don't expect
much.
Heroes of Might & Magic 1 .AGG --
Heroes of Might & Magic 2 .AGG --
MDK .??? Other files than .SNI
Mech Warrior 3 .ZBD --
Midtown Madness .AR Extract possible but I cannot give names to
files (I don't understand the format)... :(
Total Annihilation .HPI --
Total Annihilation 2 .HPI --
If you can help by giving me informations or the specification of the format,
contact me (see Contact Me chapter).
Planed work:
------------
4.?? + Add an option to replace objects into known formats (or unknown formats
by using the HyperRipper (HRF)).
+ Add an option to do invert convertion (for example, convert BMP back
to ART files).
+ Create files with known formats (ex: PACK of Quake 2, etc..).
5.00 i Reprogram from scratch for the program to be much faster and run
without the 2Mb of DLLs.
===============================================================================
9. CONTACT ME
-------------------------------------------------------------------------------
You can find latest version here:
http://www.chez.com/drgsoft/dup4/english.html
(english homepage)
You can contact the author (Alex Devilliers):
Send bug reports, comments, suggestions, etc...
E-Mail: drgsoft@chez.com
ICQ: 1535372 (elbereth)
===============================================================================
10. SPECIAL THANKS
-------------------------------------------------------------------------------
Cariad Ysbryd for his help in the test of the MP3 support in the HyperRipper
EMail: cariad@lodoss.org
URL: http://www.multimania.com/epistein2/Cariad
Descent Developper Network (DDN) for formats specs of Descent 1, 2 & 3
and Descent Freespace
URL: http://www.descent2.com/
Gustav Munkby for his 'Get "non-musical" data from an .MP3-file' homepage:
EMail: grd@swipnet.se
URL: http://home.swipnet.se/grd/mp3info/
Guy Ratajczak for his decompression code for Darkstone MTF file format:
EMail: guy.ratajczak@wanadoo.fr
URL: http://www.chez.com/misterjack/
Info-ZIP for the UnZip32.DLL v5.40 (allowing ZIP file listing/extraction)
By Info-ZIP group
Portions:
Copyright (c) 1992 Igor Mandrichenko.
Copyright (c) 1994 Greg Roelofs.
Copyright (c) 1996 Mike White.
Info-ZIP source/executables can be found from the following
Internet/WWW URL.
URL: http://www.cdrom.com/pub/infozip/
Michal Hajek for the Czech translation of Dragon UnPACKer (cestina.lng).
EMail: michal.hajek@email.cz
URL: http://bouchac.misto.cz
Michele Marcon for the Italian translation of Dragon UnPACKer (italiano.lng).
EMail: marcon@arena.sci.univr.it
URL: http://arena.sci.univr.it/~marcon
PkWARE for format specs of ZIP files
URL: http://www.pkware.com
Quake Specs v3.4 by Olivier Montanuy for format specs of Quake 1 PACK
The Wotsit's Format for all those file formats specification.
URL: http://www.wotsit.org
UPX - The Ultimate Packer for eXecutables
Copyright (c) 1996-1999 Markus Oberhumer & Laszlo Molnar
URLs: http://wildsau.idv.uni-linz.ac.at/mfx/upx.html
http://www.nexus.hu/upx
http://upx.tsx.org
===============================================================================